Converting Programs from MicroShare Basic:
------------------------------------------

The following instructions outline the procedure to convert programs 
written in MicroShare Basic to ProvideX. 

1.      Create a flat text file called PROGLIST in MicroShare's 
        Directory 0 that contains a list of the program names to 
        convert. 

2.      Start MicroShare.
3.      If the programs are in a directory that is not enabled, enable 
        the directory, making sure the correct copies of the programs 
        to convert will be accessed first. 
4.      From a MicroShare prompt (>), load the program conversion 
        routine using the following instructions: 
                DELETE
                OPEN(1)"/pvx/lib/_conv.msb/pgms2pvx.asc"
                MERGE(1)
                END
                RUN
5.      When finished, exit out of MicroShare.

6.      Start ProvideX.
7.      From a ProvideX prompt (->), type: RUN "*conv.msb/asctoprg" 
        and press <Enter>. 
8.      When asked for the Input directory, type the full path of 
        MicroShare's Directory 0 and press <Enter>. 
9.      When asked for the Output directory, type the full path of the 
        directory where the resulting ProvideX programs are to reside. 


Once these steps are complete, the output directory will contain a 
copy of all of the programs listed in the PROGLIST text file, in 
ProvideX program format.  

The results of the conversion should be checked for errors using the 
ProvideX utility called '*tools/errscn'.  

It is important to note that there are several functions native to 
MicroShare that are not directly supported by ProvideX.  The 
conversion routine will compensate for many of these functions by 
converting them to global ProvideX functions.  These functions are 
provided in a program called '*conv.msb/function.def'.  This program 
must be CALLed from the START_UP program in order for the application 
to function properly. 

Special thanks to Young Systems for providing the foundation for these 
conversion routines.

======================================================================

Converting Data files from MicroShare Basic:
--------------------------------------------

The following instructions outline the procedure to convert data files 
from MicroShare Basic to ProvideX. 

1.      Create a flat text file called FILELIST in MicroShare's 
        Directory 0 that contains a list of the data file names to 
        convert. 

2.      Start MicroShare.
3.      If the data files are in a directory that is not enabled, 
        enable the directory, making sure the correct copies of the 
        data files to convert will be accessed first. 
4.      From a MicroShare prompt (>), load the data file conversion 
        routine using the following instructions: 
                DELETE
                OPEN(1)"/pvx/lib/_conv.msb/dat2pvx.asc"
                MERGE(1)
                END
                RUN
5.      When finished, exit out of MicroShare.

6.      Start ProvideX.
7.      From a ProvideX prompt (->), type RUN "*conv.msb/cnvdat" 
        and press <Enter>. 
8.      When asked for the Input directory, type the full path of 
        MicroShare's Directory 0 and press <Enter>. 
9.      When asked for the Output directory, type the full path of the 
        directory where the resulting ProvideX data files are to 
        reside. 


Once these steps are complete, the output directory will contain a 
copy of all of the data files listed in the FILELIST text file, in 
ProvideX format.  

Special thanks to Young Systems for providing the foundation for these 
conversion routines.

Please note, these programs are provided as a courtesy and may require 
further modifications for your conversion process. If you need further
assistance, please contact ProvideX Support.
 

======================================================================

